for the Microsoft Combat Flight Simulator(CFS & CFS2)

Damage Point(DP) File Editor "DPED" Version 1.1

   ------------------------------------------------------------
   DP files are used by CFS to define damages and armaments of every
   planes that fly in the CFS world.
   DP files are plain text files - so you can modify them by any text file
   editor such as wordpad. Also you may use the editor released by Microsoft
   which is run on Excel.

   I could not found a convenient editor for myself. So, I made this one!
   ------------------------------------------------------------

  When you run DPED, main window will appear as maximized size and you may
find some sub-window icons at the bottom of this main window. These are
pop-ups!

  You may open sub-windows either using each windows' title bar buttons
or select "Window" of a menu on the main window.

  It is better to open an available DP file to understand how DPED works.
To do this, select "File" -> "Open" from menu and specify a DP file name.


CFS or CFS2 ?
~~~~~~~~~~~~~
This version of DPED can handle both DP files for CFS and CFS2. But you
have to define the version of CFS before start DPED. The default value is
"CFS2". If you want to use DPED for CFS, you have to change a parameter
in a DPED.INI file. To do this, use a NOTEPAD or any other text file editor
and modify [FLIGHT SIM] section in a DPED.INI file. You may find lines
like below in DPED.INI

#  [FLIGHT SIM]
#  ; VER 1=CFS, 2=CFS2, 2000=FS2000
#  VER=2

If you use DPED to edit CFS's DP file, you have to change the third line as

#  VER=1

or, you want to use DPED to edit CFS2's DP file, the line must be

#  VER=2


[BOXES] window:
~~~~~~~~~~~~~~~
CFS controls damage areas by boxes.
This section defines damage boxes. The section is separated in upper and
lower areas.
[Name] means a name of the damage box.
[Pos.1] and [Pos.2] is opposite points of the box. The values are in
meters and it means the distance from CG (Center of Gravity).
You may delete or add a box by clicking [Del] or [Add] button. If you
delete a box, the related [BOXMAPS] and [BOX NO] data also will removed!
By clicking right mouse button, you can choose [cut], [copy] or [paste]
function from a popup menu.
Also [Move <](move forward) and [Move >](move backward) functions are
available in the popup menu. These 'move' functions can change current box's
sequence.
[Mirror] function in the popup menu will flip current box's position to the
opposite side.
You can see how these boxes placed in the [BluePrint] window. You may change
a box size at [BluePrint] window by dragging lines of selected box which
is shown as pink.

The lower part of the window corresponds to [BOXMAPS] sections in a DP file.
[Damage Ratio] means a persentage of damage received by that part. When
the damage box is hit, the damage will affect each parts contained
in the box according to the ratio specified here. If the accumulated
damage reaches a specified amount, the damage may be considered excessive.
Normally, a total value of these ratios in one box may be "100". Total value
is shown at the right of [Damage Ratio].
[part] is a part which you want to include in this box. Before you select
a part, you have to define them in the [PARTS] window.
You may delete or add a part by clicking [Del] or [Add] button. A popup
menu function is available.
Also [Move <](move forward) and [Move >](move backward) functions are
available in the popup menu.

[BOX NO] window:
~~~~~~~~~~~~~~~~
This window will appear if you use DPED for CFS2.
These numbers are written in [BOXES] section of a dp file.
I don't know what these numbers mean.

[PARTS] window:
~~~~~~~~~~~~~~~
You may define each parts here.
[Part] is the name of the part. It will appear in CFS's telop when the
part is damaged.
[Category] defines how CFS handles the part. If you define a part as
"Engine" category, when the part is damaged, you can see the engine smoke
and feel power down. "CFS doesn't care" means the CFS doesn't show any
effect but the part may stop working when it is damaged. Normally, guns
and cannons are in this category (CFS).
[Life Point] means strength againt hits.
You may delete or add a part by clicking [Del] or [Add] button. If you
delete a part, the related [EFFECTS] data will also be removed.
A popup menu will appear when you click the right button of the mouse.
If DPED handling CFS2 file, you can define [Location] parameters.

The lower part of the window corresponds to [EFFECTS] section in a DP file.
When accumulated damage reaches this [Ratio], the effect defined
here will appear.
You may select [EFFECT] values from drop down list. You may customize
this list by editing DPED.INI file by any ordinary text file editors.
In CFS2 mode, you can choose "LIBRARY" as [EFFECT]. When you choose
"LIBRARY", you can define a file name instead of [Parm1] and [Parm2].
The file names are retrieved by DPED from EFFECTS sub-directory under the
installed path of CFS2 automatically, and added to the drop down list.
[Parm1] and [Parm2] is a smoke definition.
You may delete or add a [EFFECTS] by clicking [Del] or [Add] button.
Also you can use [cut], [copy] and [paste] function in the popup menu.

[GUNS] window:
~~~~~~~~~~~~~~
This window controls the armaments definitions.
[Trigger] is a trigger button. The value may 0,1,2 or 3. The values
correspond to each 1-4 key on a keyboard. If the "No Weapons" is specified,
the [GUNSTATIONS] and [GUNS] sections are not written in a DP file. If
the plane has no armaments, you may select "No Weapons".
[Spec] defines armaments specification. The value may 1,2,4 or 8.
[Part] is a part of this armament which is defined in the [PARTS] window.
In case you want to set armament which is not in a PARTS section, you
can set the number directory into the right window. For example, bombs(21)
and Torpedoes(62) of CFS2 are not in PARTS section.
[Round] is an interval of fire. "0.06" means 1000 rounds per minute.
[Speed] is an initial speed in (meters/second).
[Trace] is a term how long CFS traces its trajectory in second.
[Flush] means muzzle flush. Ordinary value for guns are "0.01" and
cannons are "0.05".
[Range] is concerning the timing when AI planes start shooting. When
you close towards an AI plane, the closer you are to this [Range], the AI
plane will start shooting at you.
[Sound] defines the shooting sound (eg cannon or machine gun).
[Tracer] is a percentage of a tracer (it is adviseable to keep this value
below 80% as it will affect graphics/game speed!).
[Dice] is a damage dice. "1d1*" means unit of a dice. If a value following
the "1d1*" is larger, the damage will occur to a larger area. Ordinary values
are followings.
    7.7mm    =   8
   12.7mm    =  13
   20  mm    =  20
   30  mm    =  30
  90LB Rocket=3000
  110LB Bomb =6000
An explosion warhead value may 1.4 to 3 times as big.
[Offset] is an offset value from the CG (center of gravity) in meters.
[Pitch] is UP/DOWN angle.
[Bank] is for swivel guns.
[L/R angle] is a horizontal heading in degrees. Forward = 0, Right = 90,
Left = -90, Backward = 180(-180).
[Swivel Limit] is a limit angle of swivel guns. Neutral position is
defined by [Pitch][Bank][L/R angle].
Swivel guns are only effective when the plane controls them - AI. Otherwise
the gun will fixed to neutral direction.
[Weight] is a weight of bullet in ounces (be aware that this armament weight
is added to that of the fuel and then the aircraft's dry-weight to give
a total weight!).
You may delete or add [GUNS] by clicking [Del] or [Add] button. If you
delete [GUNS], related [GUNSTATIONS] datas also will removed.

You may define armament positions at a lower part of the window.
[Bullets] is maximum and default of the number of bullets.
[Offset] is an offset from a position defined at the above.
[Pitch] and [L/R angle] is an offset angle in degrees.
[Tracer On] is defining whether tracer is visible or not (see above!).
You may delete or add [GUNSTATIONS] by clicking [Del] or [Add] button.

You may choose armaments from my armaments database. 

[Comments] window:
~~~~~~~~~~~~~~~~~~
You may put any comments at the top of the DP file.
You cannot put a blank line in a comment field.
You have to put ";" at the beggining of each comment line. The program
doesn't put leading ";" automatically.

[Blue Print] window:
~~~~~~~~~~~~~~~~~~~~
If DPED can find the MDL file in the "model" directory and the file name
 is the same as a DP file, a visual model is then shown as a wire frame.
I regret that I couldn't show a shape of the original plane in here. Some
other construction (as made by AD2000) are also not shown properly.
DPED may retrieve scrape point datas from the *.air file. These scrape
points shown on the blue print window as silver colored small squares. You may
check these scrape point values at [Scrape Points] window.

You may see the boxes defined at [BOXES] window, the armaments defined
at [GUNS] window and the hard points defined at [HARDPOINTS].
The box when selected is shown as PINK, other boxes are yellow. The
selected armament is shown as 'yellow dot with red circle'. Other armaments
are shown as purple dots.
You may change the size of the selected box and the position of the selected
armament by dragging them. The changes of the armaments position will
change values of [Offset] in a lower area of [GUNS] window.
[F][S][T] radio buttons changes the views as fore view, side view, top
view. [+] and [-] are zoom buttons. To change a center position, you
have to click the position where you want to retrieve to center by using
the right mouse button.
When you click top bar by a right mouse button, pop-up menu will appear.

[HARDPOINTS] window:
~~~~~~~~~~~~~~~~~~~~
This window will appear in case you use DPED for CFS2.
You may define hard points at here.
The place you defined here are used for the value of Mount Point in
[PAYLOADS] window.

[PAYLOADS] window:
~~~~~~~~~~~~~~~~~~
This window will appear in case you use DPED for CFS2.
[Name] is a name for this payload. The name is also shown in [STRING LIST]
window.
You may delete or add [PAYLOADS] by clicking [Del] or [Add] button. If you
delete [PAYLOADS], related datas in lower part of this window also will
removed.
[Mount Point] is a number of the position you defined at [HARDPOINTS]
window.
[Payload] is a file name. The file names are retrieved automatically by
DPED from OBJECTS_DP sub-directory under the installed path of CFS2,
and added to the drop down list.

[MISC DATA] window:
~~~~~~~~~~~~~~~~~~~
This window will appear in case you use DPED for CFS2.
If you want to set default values of this section, you can put values
in a DPED.INI file as follows;

[MISC DATA]
unit_family=1
category=1
allegiance=4
max_group_size=8
min_speed=240
cruise_speed=440
max_speed=650
min_alt=50
cruise_alt=6667
max_alt=10000
entered_service=9/1/43
crew=1

[Armaments] window:
~~~~~~~~~~~~~~~~~~~
This window is not a "MDI sub-window" so that the window is not open
when DPED starts.
To open this window , select "Edit"->"Armaments" from the menu, or right
button click on the [GUNS] window.
You may apply any one of the database armaments to the [GUNS] window. To
do this, select an armament and press [apply] button or double click
an armament.
You may add a new armament from [GUNS] window to this database by
pressing [Add] button, then define name and comment, press [OK].
The target of these [Apply] or [Add] operations are selected page of
the [GUNS] window.
[Del] button deletes selected armament from the database.
[Up] and [Down] button changes a position of selected armament.
You may change name and comment by clicking right button of the mouse.

[STRING LIST] window:
~~~~~~~~~~~~~~~~~~~~~
This window contains box names(CFS2), payload names(CFS2), and part names
which related to the [PARTS] window. You may move selected parts up/down
by pressing up or down arrow buttons. When you move a part, a sequence
in [PARTS] window also may changed.

[Change Scale] window:
~~~~~~~~~~~~~~~~~~~~~~
To open this window, you have to select "Edit"->"Scale" from the menu.
You may set scale value between 0.5 to 5.0.
This scale expands or reduce damage boxes acoording to the value. Also
offsets of guns may adjusted here too.

[Scrape Points] window:
~~~~~~~~~~~~~~~~~~~~~~
To open this window, you have to select "Window"->"Scrape Points" from
the menu.
You can change scales either in inches or meters by pressing "in/m" button.
But you cannot change values itself. Because these values are not in the DP
file. These values are retrieved from .AIR file. If the associated air file
is not available, "Scrape Points" may not exist in the menu.


When you have finished work, you have to save the file by selecting "File"
from a main menu.
------------------------------------------------------------
